home *** CD-ROM | disk | FTP | other *** search
/ The World of Computer Software / The World of Computer Software.iso / cron093.zip / CHANGES.DOC next >
Text File  |  1993-01-05  |  6KB  |  137 lines
  1.  
  2.     Changes made to cron 0.93:
  3.     -------------------------
  4.  
  5.     - for some reason (lack of sleep?) cron was not compiled properly,
  6.       and as a result, would abend when spawning a task.
  7.  
  8.     Changes made to cron 0.92:
  9.     -------------------------
  10.  
  11.     - you can now re-scan the crontab file while cron is running,
  12.       instead of having to restart.  Use r/R from the cron session.
  13.  
  14.     - one of the most requested features was to have cron automatically
  15.       rescan the crontab file to pick up new changes.  I really didn't
  16.       want to do this, since the standard cron doesn't; it would also
  17.       require substantial re-working of the code.  But HEY, it was the
  18.       first day of the new year, so I said, 'What the hell!'.  So, by
  19.       cleaning up the code and adding a few lines, I was able to add
  20.       re-scanning of the crontab file every n seconds.  To use this
  21.       feature, use -r with or without an argument (seconds).  If no
  22.       argument is specified, 5 minutes is assumed.  Minimum interval is
  23.       15 seconds. Unfortunately, there is no way to have a thread
  24.       notified when a file is changed (in standard C - it could probably
  25.       be done with SOM), so I have to check every n seconds.
  26.  
  27.     - To prevent accidental termination of cron, you can now tell cron
  28.       to ignore Ctrl-C/Break messages (SIGINT) from OS/2.  When this
  29.       option (-i) is enabled, you can only terminate cron directly by
  30.       using Ctrl-Alt-Q. You can still kill the process (by sending cron
  31.       a SIGTERM), however.
  32.  
  33.     - d/D will display a list of command and arguments that are currently
  34.       defined to cron.  This is more of a debugging tool, but I thought it
  35.       might be useful.
  36.  
  37.     Changes made to cron 0.91:
  38.     -------------------------
  39.  
  40.     - lines may now be split across two lines, to make reading the file
  41.       a little easier.  As a result, a ';' is required to terminate the
  42.       cron entry
  43.  
  44.     - additional options are now available, which appear after the
  45.       optional command arguments string.  The available options are:
  46.  
  47.         ::  title="title of window"
  48.         ::  fgbg=[fg|bg]
  49.         ::  type=[def|wvio|fs|pm|vdm|wvdm]
  50.         ::  control=control_options (see below)
  51.         ::  pos=(#,#,#,#)
  52.  
  53.         [a|b|c] means choose ONE of a, b, or c
  54.  
  55.     title="title of window"
  56.  
  57.         this is the string that will be displayed in the title bar of
  58.         the window when it is visible.  If this is not specified, the
  59.         title defaults to the invocation name of the command.
  60.  
  61.     fgbg=[fg|bg]
  62.  
  63.         sessions can be created to either being in the foreground or the
  64.         background of the desktop.  The default is background.  NOTE: if
  65.         cron is not the current foreground session (it has the focus)
  66.         specifying a task as fg will cause an error, since OS/2 will
  67.         not let a background session start a foreground session (go
  68.         figure!)
  69.  
  70.             :: fg - create session as a foreground session
  71.             :: bg - create session as a background session
  72.  
  73.     type=[def|fs|wvio|pm|vdm|wvdm]
  74.  
  75.         this specifies the type of session that is to be started.  OS/2
  76.         by default will probably create the correct one - you should
  77.         only use this option to specify that a session is to be a full
  78.         screen VDM session or an OS/2 full screen session.  Choosing the
  79.         wrong value will lead to spawn errors.  Here is what the options
  80.         mean:
  81.  
  82.             :: def  - default mode, let OS/2 choose the type
  83.             :: fs   - OS/2 full screen session
  84.             :: wvio - Windowed VIO session
  85.             :: pm   - Presentation Manager Program
  86.             :: vdm  - virtual dos machine (full screen)
  87.             :: wvdm - windowed VDM
  88.  
  89.     control=control_options (see below)
  90.  
  91.         For each session, you can specify a number of options.  These
  92.         options are:
  93.  
  94.             :: vis      - window is to be visible
  95.  
  96.             :: invis    - window is to be invisible
  97.  
  98.             :: max      - start session maximized
  99.  
  100.             :: min      - start session minimized
  101.  
  102.             :: nac      - no auto close on window session - this option
  103.                           is only applicable to Windowable VIO sessions
  104.                           - it is ignored for all others.
  105.  
  106.             :: setpos   - specify screen position for the window - if
  107.                           you specify this option, you must also include
  108.                           the pos=() option.  If you don't, the window
  109.                           will have zero size, and will not be
  110.                           displayed.
  111.  
  112.         These control options can be combined using the '&' operator.  See
  113.         the below for an example.
  114.  
  115.     pos=(x,y,cx,cy)
  116.  
  117.         If you specify control=setpos, you should also specify the
  118.         screne positions. Arguments 1 and 2 specify the lower left hand
  119.         corner of the scren, and 3 and 4 speicfy the size in the x and y
  120.         directions, respectively.
  121.  
  122.     Examples:
  123.  
  124.         Let's create a crontab entry that will start a windowed dos
  125.         session at 00:15 on the first day of the first 6 months of the
  126.         year.  To really make things interesting, lets position the
  127.         screen at (50,50) and give it a width of 100 pixels, and a
  128.         height of 75:
  129.  
  130.         15 00 1 1-6 * "c:\os2\mdos\command.com" "c:\bin\test.bat"
  131.                           title="This is a test session"
  132.                           type=wvdm
  133.                           control=vis&setpos
  134.                           pos=(50,50,100,74);
  135.  
  136.  
  137.